Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Movie User Data

RemoveUserData

The RemoveUserData function removes an item from a user data list. After the Movie Toolbox removes the item, it renumbers the remaining items of that type so that the index values are sequential and start at 1.

pascal OSErr RemoveUserData (UserData theUserData, OSType udType, 
                              long index); 

theUserData

Specifies the user data list for this operation. You obtain this list reference by calling the GetMovieUserData, GetTrackUserData, or GetMediaUserData function (described on page 2-215, page 2-216, and page 2-217, respectively).

udType

Specifies the item's type value.

index

Specifies the item's index value. This parameter must specify an item in the user data list identified by the parameter theUserData.

ERROR CODES

userDataItemNotFound

-2026

Cannot locate this user data item

Memory Manager errors